按数据树分支将几何、文字、标注或文档对象导出为 3DM、DWG 或 STEP 文件，并在导出结束后恢复引用对象的显示、锁定和选择状态。
功能概览
组件把 Geometry 数据树的每个非空分支视为一个独立导出任务，再为该任务匹配文件路径和可选图层名称。触发后按右键选择的格式逐项写出；引用自 Rhino 文档的对象会在导出期间临时调整为可导出状态，结束后恢复原有选择、隐藏和锁定状态。组件没有结果端口，交付判断必须结合运行消息和实际生成的文件。
适用场景
- 把多个数据树分支批量导出为各自独立的文件。
- 为每个分支指定输出路径和目标 Rhino 图层。
- 导出当前隐藏或锁定的引用对象，同时保持操作后的文档状态。
工作流程
- 右键组件选择 3DM、DWG 或 STEP 格式。
- 按文件分组整理 Geometry 数据树。
- 提供不带扩展名的路径树，并按需提供图层名称树。
- 先检查路径和分支对应关系，再将 Start 设为真或点击“导出”。
- 查看每个分支的成功、失败和不支持类型消息，并检查目标文件。
输入
| 端口 | 要求 | 数据与匹配 | 空值、默认与误接 |
|---|---|---|---|
| Geometry G | 必需 | 物件数据树；支持几何、文字、注解点、尺寸标注和 Rhino 对象标识。每个非空分支形成一次独立导出。 | 空分支跳过。无法支持的类型不写入并报告；注解点明确不支持导出。不要把路径文本混入此树。 |
| PathWithName P | 必需 | 带文件名但可不带扩展名的文本树。优先按相同路径匹配；单个值广播到所有几何分支；否则可按分支顺序匹配。 | 缺失、空白或无效路径使对应分支失败。输入即使带扩展名，最终扩展名仍由右键选择格式决定。 |
| Layer L | 可选 | 目标图层名称树，使用与路径相同的匹配规则；几何和文字使用该指定名称。 | 未输入时，组件按几何树路径为每个分支建立 ExportedGeo 与 ExportedText 子图层名称。 |
| Start S | 触发项 | 单个布尔值；为真时执行全部分支导出。 | 默认假。也可点击组件“导出”按钮；普通上游变化在未触发时不会写文件。 |
输出
| 端口 | 结果 | 结构与下游 |
|---|---|---|
| 无输出端口 | 结果写入目标文件，并通过运行消息报告。 | 没有成功布尔值或路径输出；应通过消息、文件存在、文件非空及更新时间判断结果。 |
实际示例
Geometry 有 {0}、{1}、{2} 三个分支，分别存放三件产品；PathWithName 只有一个分支和三个不同路径时，可按分支顺序对应，或为每个路径建立相同 GH 路径以获得最明确的匹配。右键选择 DWG，Layer 留空，触发导出后生成三个 DWG，并按分支建立自动图层名称。若 {1} 的路径为空，该分支报错，但其他具有有效路径的分支仍可继续处理。
设置与交互
右键菜单只提供 3DM、DWG 和 STEP，最终文件扩展名始终服从这里的选择。“导出”按钮与 Start=true 均可触发。导出期间引用对象可能被临时显示和解锁，结束后恢复选择、隐藏及锁定状态，并清理临时对象；该过程不应被当作永久修改文档的方式。
配合使用
上游用数据树路径定义文件分组，并可先通过图层标记或烘焙流程确定分类。导出后没有可连接输出，后续自动化应读取组件消息或独立检查目标文件。DWG 对对象类型和当前导出方案有要求，复杂批次建议先用少量文件验证。
常见问题与限制
- 目标路径需包含文件名；目录不存在时会尝试创建，但无效路径或权限问题仍会失败。
- 目标文件被占用、格式不支持对象类型或导出命令未成功结束时会报告失败。
- 注解点不受支持并会明确跳过；同一分支中的其他支持对象仍可参与导出。
- 组件没有输出端口，不能仅凭 Grasshopper 求解完成判断文件成功，应检查运行消息与实际文件。